Method | show_forum(width, start, maxmsgs) Description:  Use this method to output a forum to a webpage.  The method will draw, or "show," the loaded forum in standard HTML to be rendered by any browser.  Note that a successful call to "load_forum()" must be made before "show_forum()" can be called.

width (required, String):  String representation of an HTML usable width (i.e. "75%", or "550") for the forum.
start (optional, Integer): 1-based Index of first top level message to display.  For instance, if your pages are designed to show 10 top level messages per page, and you wish to display the second page, the "start" value would be 10.  The default is to start displaying with the first top level message in this forum.
maxmsgs (optional, Integer): Maximum number of top level messages to display.  The default value for maxmsgs is 30.

Common usages (Jscript ):
forumobj.show_forum("90%");
forumobj.show_forum("500", 30);
forumobj.show_forum("50%", 20, 10);
Method | show_composemessage(parentid)
Description:  Use this method to output a form to be used to compose a message for the loaded forum.  This method will draw, or "show," a form that is ready to be used in standard HTML to be rendered by any browser.  Note that a successful call to "load_forum()" must be made before "show_composemessage" can be called.

If a parentid is supplied, this method will pre-populate the form with the parent message just below a divider ("----------") and space for the user to add their own message.

You are free to create your own forms for users to compose messages for a particular forum, just make sure all the expected form elements are submitted to the receiving page.

parentid (optional, Integer):  ID of a currently existing message, if the new message that is to be composed is a REPLY to a currently existing message.  The default value indicates that the user will be submitting a new top level message (not a reply to any other existing messages)

Common usages (Jscript ):
forumobj.show_composemessage();
forumobj.show_composemessage(956);
Method | show_viewmessage(msgid, width)
Description:  Use this method to output a forum message from the database  This method will draw, or "show," a forum message that is ready to be used in standard HTML to be rendered by any browser.

msgid (required, Integer):  ID of the forum message that should be loaded
width (optional, String): String representation of an HTML usable width (i.e. "75%", or "550") for the forum message output.

Common usages (Jscript):
forumobj.show_viewmessage(956);
forumobj.show_viewmessage(956, "100%");
Method | show(width, action, id, start, max)
Description:  Based on the value of the "action" parameter, this method outputs the forum, a compose message form, or an individual message display.  Note that a successful call to "load_forum()" must be made before "show()" can be called.

Tip: Although this function is flexible and can be used in many different ways, please see the supplied example file "forum.asp" for an example of how this function is intended to be used -- Using parameters supplied in the URL.

The "show()" method works like this:

 if( action == "nothing" )
  show_forum( width, start, max );
else if( action == "view" )
  show_viewmessage( id, width );
else if( action == "post" )
  show_composemessage( id );
else
  show_forum( width, start, max );
width (optional, String):  String representation of an HTML usable width (i.e. "75%", or "550") for the output.
action (optional, String): String representing the action to take.  Actions that are understood include "view", "post", and "nothing".  See above.  Note that a successful call to "load_forum()" must be made before "show()" can be called, and all actions taken are based on the currently loaded forum.
id (optional, Integer): If the action parameter is "view," this "id" parameter should indicate the message ID that which should be displayed.  If the action parameter is "post," this "id" parameter should indicate the parent ID (or the ID to which the new message will be a reply), if there is one.  If the action parameter is not supplied, or equal to "nothing," this "id" parameter is ignored.
start (optional, Integer): If the action parameter is "nothing" or not supplied, the start parameter is passed to the show_forum() method as the start value.  This parameter is ignored in all other cases.
max (optional, Integer):  If the action parameter is "nothing" or not supplied, the max parameter is passed to the show_forum() method as the max value.  This parameter is ignored in all other cases.

Common usage (Jscript):
forumobj.show();
forumobj.show("75%");
forumobj.show("500", "post");
forumobj.show("500", "post", 349);
forumobj.show("100%", "view");
forumobj.show("100%", "nothing", 0, 30, 10);
forumobj.show("90%", action, id, start, 15);       <--  From example file, forum.asp
Method | show_forumlist(width, order, viewpage, editpage)
Description:  This method outputs a complete list of the forums currently stored in the forums database.  This method can also be used to provide users access to the individual forums, and/or their respective editpage (page designed to edit the forum properties).

width (optional, String):  String representation of an HTML usable width (i.e. "75%", or "550") for the output.  Default is "100%"
order (optional, Integer): Ignored in the express version of bf.forums, this parameter is used to control the order that which the forums are displayed.
viewpage (optional, String): A relative or absolute path to a page developed to view a particular forum.  In the example implementation supplied with bf.forums express, this would be, with a relative path, "forums.asp"
viewpage (optional, String): A relative or absolute path to a page developed to edit a particular forum.  In the example implementation supplied with bf.forums express, this would be, with a relative path, "editforum.asp"

Common usage (Jscript ):
forumobj.show_forumlist();
forumobj.show_forumlist("50%");
forumobj.show_forumlist("100%", 0, "forum.asp");
forumobj.show_forumlist("100%", 0, "myforums/forum.asp", "../admin/editforum.asp");
Method | new_forum(title, description)
Description:  Creates and inserts a new forum into the database.

Returns:
If the forum creation was successful, the ID of the newly created forum will be returned.  0 (zero) will be returned otherwise.

title (required, String):  Title of the new forum.
description (required, String): Description of the new forum.  If you do not wish to have a description associated with this forum, use a zero-length string ("")for this parameter.

Common usage (Jscript ):
var newid = forumobj.new_forum("My new forum", "");
var newid = forumobj.new_forum("My new forum", "My description here.");
Method | edit_forum(forumid, title, description)
Description:  Updates the specified forum's title and description in the database.

Returns:
true if thought to be successful, false otherwise.

forumid (required, Integer):  ID of the forum that should be loaded
title (required, String):  New title of the forum.
description (required, String): New description of the forum.  If you do not wish to have a description associated with this forum, use a zero-length string ("")for this parameter.

Common usage (Jscript ):
var success = forumobj.edit_forum(96, "My favorite forum", "");
var success = forumobj.edit_forum(96, "Discussions", "My description here.");
Method | delete_forum(forumid)
Description:  Deletes the specified forum from the database.

Returns:
true if thought to be successful, false otherwise.

forumid (required, Integer):  ID of the forum that should be deleted.

Common usage (Jscript ):
var success = forumobj.delete_forum(3645);
Method | post_message(parentid, grandparentid, subject, text, author)
Description:  Inserts a forum message in the database associated with the loaded forum.  Note that a successful call to "load_forum()" must be made before "post_message()" can be called.

parentid (required, Integer):  If the message to be posted is a reply to another message, the ID of the other message should be supplied here.  Use 0 (zero) if this is a top level message (not a reply).
grandparentid (required, Integer): Ignored in the express version of bf.forums.  The value of 0 (zero) is recommended.
subject (required, String): String representing the "Subject" of the new message.
text (required, String): String representing the body "Text" of the new message.
author (required, String): String representing the "Author" of the new message.

Common usage (Jscript):
forumobj.post_message(34, 0, "My Message", "This is my message...", "John");
Method | edit_message(messageid, author, subject, text)
Description:  Edits an existing message in the database.

messageid (required, Integer):  ID of the message to edit.
author (required, String): String representing the new "Author" of the message.
subject (required, String): String representing the new "Subject" of the message.
text (required, String): String representing the body new "Text" of the message.

Common usage (Jscript ):
forumobj.edit_message(634, "A. Smith", "Message from Smith", "Message here...");